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ABSTRACT 


CIPE (the Concurrent Image Processing Executive) is both an executive which organ- 
izes the parameter inputs for hypercube applications and an environment which pro- 
vides temporary data workspace and simple real-time function definition facilities for 
image analysis. CIPE provides two types of user interface. The Command Line Inter- 
face (CLI) provides a simple command-driven environment allowing interactive func- 
tion definition and evaluation of algebraic expressions. The menu interface employs a 
hierachical screen-oriented menu system where the user is led through a menu tree to 
any specific application and then given a formatted panel screen for parameter entry. 

This document describes how to initialize the system through the ’setup’ function, how 
to read data into CIPE symbols, how to manipulate and display data through the use of 
’executive functions’, and how to run an application in either user interface mode. 
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INTRODUCTION 


CIPE (the Concurrent Image Processing Executive) is both an executive which organ- 
izes the parameter inputs for hypercube applications, and an environment which pro- 
vides temporary data workspace and simple real-time function definition facilities. In 
the more function-rich command mode, all of these capabilities are available to the 
user. In the menu mode, the concentration is on the executive with the goal being to 
guide the user in the definition of parameters for specific applications. 

The command mode uses a simple line-at-a-time, command-driven interface. In the 
menu mode, the user is led through a menu tree to specific applications and then given 
a formatted panel screen to fill out. Navigation and help are accessed through function 
keys. 

The main purpose of CIPE is to make hypercube processing available in a straightfor- 
ward way. It was assumed that the concurrent processor is connected to a host com- 
puter system which includes the usual broad range of operating system services, file 
I/O, display device hardware, network connections, etc. In order to develop an image 
processing executive for a virtual concurrent system environment, system setup pro- 
cedures, data management schemes among multiple systems, and concurrent system 
interface methods were implemented. A set of ’executive functions’ is provided by 
CIPE to setup the system configuration and to manipulate data. All image processing 
applications being developed for the hypercube will also be made part of the CIPE 
environment. 

Due to the data-heavy characteristic of image processing, CIPE minimizes data I/O by 
keeping data resident and by loading image processing functions incrementally at run 
time. This is especially crucial with the hypercube since there is a serious data transfer 
bottleneck between host and hypercube. Image processing functions are managed in 
CIPE through a function dictionary file which keeps a record of all available applica- 
tion programs. When a user requests a function, CIPE searches for the requested func- 
tion name in the function table and reads its executable module into the system. A 
user can also activate his own executable module by specifying the module name. 
Datasets are managed in CIPE via a symbol table. Each dataset is represented by a 
CIPE ’symbol’ which is a data structure containing the size, datatype, physical data 
location, and data distribution map if the data is in the hypercube. 

This User’s Guide is composed of the following five main sections: 

Command Mode - A description on maneuvering through the Command Mode; what 
the terms mean and how the pieces interact. 

Menu Mode - How to use the Menu Mode; how the menus are organized and how 
parameters are fed to applications. 

System Setup - A description on setting up the computing system configuration. 
Executive Functions - Functions for data manipulation and image display. 

Applications - Current list of application functions available through CIPE. 
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1. COMMAND MODE 


It is not necessary to understand the workings of the system internals described here to 
be able to use the system. If you simply want to run a couple of applications, you can 
skip this section and turn directly to section 2 — Menu Mode. 

When you first start CIPE (by typing ’cipe’ at the Unix prompt) it responds with an 
initialization statement, followed by the CIPE prompt: ’>’. For a list of the built-in 
commands see Table I. For a list of the applications functions and their arguments, see 
section 5. At the CIPE prompt, if you wish to see a list of the CLI (Command Line 
Interface) commands and applications functions type ’help’. To obtain help on an indi- 
vidual command or function, type ’help command/function_name. The CLI also 
allows the user to escape CIPE execution temporarily and run such operating system 
utilities as editing a file. 

CIPE has four main constructs that the user can manipulate: 

SCRIPT — a grouping of commands (functions and simple control statements) typed 
in by the user and used to perform higher level tasks (e.g. image filtering combined 
with background subtraction and display as one function invocation). Scripts can make 
use of the ’DEFINE’ command to allow argument substitution. In this way scripts are 
frequently referred to as ’functions’ or ’macros’. They may be thought of as ’user 
defined functions’ as opposed to CIPE functions. Scripts also resemble user-defined 
procedures by allowing commands or functions to be performed repetitively through 
looping and other conditional statements. An example of a macro file is given in Table 
II to illustrate how script can be a powerful way of utilizing the CLI mode features 
such as nested function calls (pipe), nested macro calls, and nested control statments. 
The macro Ip3-512 in Table II merges two 512 by 512 images while eliminating the 
seam line on the boundary by using the pyramid image processing technique. Two 
basic pyramid tools ’reduce’ and ’expand; and a subroutine ’concat’, (which averages 
the boundary pixels between two concatenated images) are called repeatedly by the 
macro. 

WORKSPACE -- a script (i.e. group of DEFINEd commands of functions) stored on a 
permanent disk file which can be reloaded or edited. LOADing a workspace causes 
each of the lines in the file named to be executed. Any DEFINEd functions that have 
been typed in by the user (or by a previous LOAD for that matter) can be SAVEd to a 
file. These files can be EDITed at any time (EDIT invokes the vi editor). Files 
created by EDIT can be LOADed and are not restricted to DEFINEd functions, as is 
the case for SAVEd files. 

VARIABLE - all data accessed by CIPE functions must be stored internally in tem- 
porary working space and referred to through variable names. A variable may refer to 
an integer constant, a three dimensional array of floating point numbers or anything in 
between. The allowed data types are 8-, 16-, and 32-bit integers (C datatypes unsigned 
char, short int, and int) and 32-bit floating point (C datatype float). Variables can 
represent single numbers (e.g. a=6), or 1-, 2-, or 3-dimensional arrays. Variables can 
be grouped into expressions using arithmetic and logical operators (e.g. b*c+7 or a>c). 
Such constructs are particularly useful to allow looping and checking inside DEFINEd 
functions. 
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Table I: List of CEPE commands 


syntax 

description 

DEFINE function (formal_args) 
command list END 

define a function as a collection 
of commands or functions 

EDIT workspace 

edit a workspace using vi screen editor 

FOR variable = expr TO 
expr commandjist END 

performs same set of commands or 
functions multiple times 

FOR variable = expr TO expr 
STEP expr command_list END 

same as last command 

HELP command/function_name 

display a list of CLI commands and 
existing application functions including 
user-defined functions and scripts 

IF expr THEN cmdjist ELSE IF 
ELSE IF expr THEN cmdjist... 
ELSE cmdjist ENDIF 


LOAD workspace 

retrieve a workspace from the disk and execute 
the commands or functions in the workspace 

PRINT exprjist 

display the specified value(s). Multiple 
values should be separated with commas. 

QUIT 

exit CIPE section 

READ variable FROM "filename" 

read data from disk file to variable 

SAVE workspace 

save all current user-defined functions 

SET attribute TO value 

specify attribute, existing attributes are: ’coprocessor’, 
’cube dimension*, ’display device id’ and ’debug level’ 

SHOW func_name 

print the user-defined function in a pretty format 

SYMBOLS 

show a list of all existing symbols 

TRACES 

show the traceable system parameters and their trace status 

TURN boolean attribute 

boolean is either ’on; or ’off, boolean attributes 
are: ’mouse’, ’logging’, ’appl trace’ 

WHILE value commands END 

executes a set of commands or functions in a WHILE loop 

WRITE value TO filename 

write data to a disk file 

output_variable = expr 

assign the value of expr to output variable 

function (expr) 

execute a function 

lunixcommand 

perform the specified unix command 
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Table II : An Example on Macro File 


define cat512(x,y) 

cat512=concat(copy(x,{ 1,1,512, 256}), copy(y,(l,257,512,256}),l,l) 
end 


define cat256(x,y) 

cat256=concat(copy(x, ( 1 ,1 ,256, 1 28 } ),copy(y, { 1,129,256,128 } ),1,1) 
end 

define catl28(x,y) 

catl28=concat(copy(x, (1,1,128,64 } ),copy(y, { 1,65,128,64} ), 1,1) 
end 

define cat64(x,y) 

cat64=concat(copy(x,(l,l,64,32}),copy(y,(l,33,64,32}),l,l) 

end 

define lp(a,ar) 

lp=sub(a,expand(ar,l)) 

end 

define lp3_512(x,y) 
xrl=reduce(x,l) 
xr2=reduce(xrl,l) 
xr3=reduce(xr2,l) 
yrl=reduce(y,l) 
yr2=reduce(yrl,l) 
yr3=reduce(yr2,l) 
lpxO=lp(x,xrl) 
lpxl=lp(xrl,xr2) 

Ipx2=lp(xr2,xr3) 

IpyO=lp(y,yr 1) 
lpyl=lp(yrl,yr2) 

Ipy2=lp(yr2,yr3) 

Ipxy0=cat512 (1 pxO,l py 0) 
lpxyl=cat256(lpxl,lpyl) 

Ipxy2=catl28(lpx2,lpy2) 
xy3-cat64(xr3,yr3) 
txy 2=expan d(xy3, 1 ) 
xy2=add(txy2,lpxy2) 
txyl=expand(xy2,l) 
xyl=add(txyl,lpxyl) 
txyO = expand(xyl,l) 
lp3_512 = add(txyO,lpxyO) 
end 
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Variable references are ’symbols’ in the CIPE syntax. A user may create symbols by 
reading a file, by copying an existing symbol (B = A), by assigning a set of values (C 
= {2,2}), or by activating a function ( D = sqrt(A)). As a symbol is created, its com- 
plete set of data attributes are stored in the symbol table. A user may also delete a 
symbol (delete(A)) or overwrite a symbol. 

ATTRIBUTE - an internal CIPE flag. Attributes tell CIPE such things as which 
display device to use and whether to keep a log file or not. Attributes come in two 
types: ones that have values that may be SET to a value, and ones that are Boolean 
flags and can only be TURNed on or off. 

At the command mode prompt, the user must enter either a built-in command or a 
function call (with arguments). These function calls can be to applications functions, 
to DEFINEd functions (i.e. SCRIPT described above), or to functions the user created. 

The following shows a simple example of a CIPE CLI session. In this example, the 
user reads in a blurred image and a blurring kernel from disk files, restores the image 
with function ’ML’, and displays the resultant image with the ’draw’ function. 

unix% cipe 
CIPE Version 3.2 

> set display device id to 0 

> read a from "/ufs/images/blur.img" 

> read k from "/ufs/images/kemel.img" 

> b = ML (a, k, 4.0, 10) 

> draw (b, {1,1}) 
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2. MENU MODE 


Menu mode is a relatively painless way to find and execute a specific application pro- 
gram. Its interface to the user is a set of screens, each consisting of three windows 
(see Figure 1). The top window (function window) contains the current menu, the bot- 
tom window (menu control window) has status and general usage information, and the 
large middle window (parameter window) will have the parameter fields to be filled out 
for the application and any messages that are sent out. 

To invoke Menu mode from Command mode, enter the command ’menu’ at the 
prompt. In the Main Menu (shown in Figure 1), each of the entries in a menu 
represents either a sub-menu or a function. The following two simple naming stan- 
dards are adopted to make these two types of names easily distinguishable: ’all func- 
tion names are in lower case except for acronyms’, and ’the sub-menu names have a 
"+" suffix. Picking a sub-menu (either by moving the cursor to that item and typing a 
carriage return or by typing the number associated with the item) causes that menu to 
take the place of the current menu. Picking a function causes the parameter list (with 
blanks for the values to be filled in) to appear in the parameter window. Once the 
values have been entered, the application can be run. 

Maneuvering around the menu tree is done by selecting sub-menus, popping up one 
level in the tree by typing T, or jumping up to the top of the tree with 'R. Help on 
menu items or function parameters is available through "H. 

Some of what look like functions in Menu mode are really groups of built-in CIPE 
functions (e.g. ’math’ functions). However, this is transparent to the user. Also, 
because the menus are not intrinsic to CIPE but rather are convenient user aides, there 
is nothing to prevent applications or even whole menu structures from being duplicated 
at different places in the tree. Since there is no way to jump laterally across the tree 
this is sometimes advantageous. For this reason, the ’disp+’ and ’symbol+’ sub-menus 
appear in every application entry. In addition to the CIPE provided application func- 
tions, CIPE also allows the user to execute his own application functions (ref. 
’cipedict’ in section 3, ’System Setup’). 

The following is an example showing how to restore a blurred image using the restora- 
tion function provided by CIPE. In general, there are three steps in running an appli- 
cation program: (1) set up the environment such as the coprocessor used and its dimen- 
sion, display device, trace level, etc. (2) read input data to symbols either from disk 
files or through menu inputs, (3) specify function name and fill in all the parameters 
needed. Step 1 only needs to be done once per CIPE session; 2 and 3 can be repeated 
as many times as necessary. 

The example will use the ’ML’ function to restore an image using the host computer. 
The blurred image and the kernel matrix are stored in the disk files ’blur.img’ and 
’kemel.img’. All image files in CIPE need to have a header file specifying the dimen- 
sion and the datatype of the image. The associated header files for the two files used 
here are ’blur.hdr’ and ’kemel.hdr’. 

Once the user has the input image files and appropriate header files, he enters cipe and 
types ’menu’ to get into Menu mode. At the main menu, he uses ’setup’ to specify the 
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processor to be used, the trace level, etc. (The detailed descriptions of each field in the 
’setup’ menu and the allocation of the display device will be described in section 3, 
’System Setup’.) Next the ’restore+’ sub-menu is selected (Figure 2), and the ’read’ 
function in the ’symbol+’ sub-menu is invoked to read the data into CIPE symbols as 
shown in Figure 3. In the example, data in ’blur.img’ is read into the CIPE symbol 
’a’, with the parameters from the header file ’blur.hdr’ automatically inserted as the ini- 
tial definition of the image area (start line, start_pixel, number_of_lines, number of 
_samples). 

Again in the ’restore+’ menu, the ’ML’ function is selected. The user simply fills out 
the list of parameters shown in Figure 4, and the program runs with the resultant image 
going to symbol ’b’. 

After the execution of the program, if the user wishes to display the resultant image, he 
selects sub-menu ’disp+\ In the example, we display the restored image ’b’ using 
’draw’ function (assuming that we have allocated and selected the display device at the 
beginning of the session). Figure 5 shows the list of parameters to be filled in the 
’draw’ function. 
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Figure 1 : Main menu 



restore* , 'H=Help "R=Main Menu ~P=Previous menu 

"X=Exit "D=Hardcopy RETURN=End select 


Figure 2: Restore submenu 
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O.list l:read 2:copy 3:assign 4:save 5:delete 6:print 



symbol+ ~H=Help T=Abort data entry ~T=Next value 

"L-Refresh ~E=End data entry ~D=Hardcopy 


Figure 3: Read function in menu mode 



Figure 4: Example for executing ML function in menu mode 
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3. SYSTEM SETUP 


This section describes the functions that perform interactive system configuration. 
They include the allocation of the coprocessor along with the selection of various 
debugging and tracing levels, and the selection and allocation of the display device. In 
menu mode, these functions are performed through the use of the ’setup’ function in 
the main menu and the functions under ’alloc+’ submenu. 


setup function 

In menu mode, a list of parameters is presented to the user (Figure 6) to be filled in. 
In CLI mode, however, it requires a system command to specify each parameter. The 
following is the list of parameters to be set. The exact syntax (shown in block letters) 
is required for the command to be accepted in the CLI mode. 


coprocessor 

This parameter enables the user to allocate and de-allocate a coprocessor. 

> set coprocessor to coprocessor _name 
or 


> set coprocessor to none 

Since the hypercube is a single user system, de-allocating it allows sharing of the cube 
among multiple users. 


cube dimension 


This parameter sets the hypercube dimensions. For a dimension of n, the hypercube 
provides 2* nodes. This field will be shown on the screen if the coprocessor is 
specified. 

> set cube dimension to n 


logins. 

This option allows the user to have a log file created which records what the user has 
done during the CIPE session. This file is created in the user’s home directory under 
the name ’session.log. pid’ where pid is the process identification number of the ses- 
sion. 

> turn on logging 
or 

> turn off logging 
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Figure 5: Example for displaying output symbol in menu mode 



0:setup 

2:disp+ 

4:builtin+ 

6:filter+ 

8:geom+ 

1 :symbol+ 

3:mssdisp+ 

5:xform+ 

7:restore+ 

9:stretch+ 


Coprocessor no coprocessor 


Logging? NO 


Trace On? NO 


Menuconfig 
Dictionary 
Input path 
Output path 


/judyAifs/cipe/menuconfit 

/judy/ufs/cipe/cipedict 

V 

7 



Main Menu *E=End data entry 

*H=Help 

"T=Next value 

T=Abort data entry 

'D=Hardcopy 

TAB=Next field 
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trace 


This trace turns on the debugging statements from the application program: 

> turn on appl_trace 
or 

> turn off appl_trace 

debug level 

A set of parameters are provided which can be set for tracing the specific executions of 
functions. They include command line interpreter function related traces (parse_trace, 
lex trace, codegen trace, functabtrace), a symbol table manipulation related trace 
(symtab_trace), hypercube executive traces (cubecommand, cubedata, 
cubesyinbol), and a general CIPE execution trace (exectrace). A parameter called 
’debug level’ is provided to control the details of the trace; however, these traces are 
meant for the programmer rather than a typical user. 

> turn on name (e.g. executive) trace 
or 

> turn off name (e.g. executive) trace 

In menu mode, the user may specify only appl_trace which selects the level of debug- 
ging messages provided in the application programs. 

menucon^g 

Figure 7 shows the entire menu tree as defined by the standard CIPE ’menuconfig’ file 
(Appendix A). CIPE allows the user to activate a different menu tree by supplying an 
alternative menu configuration file in the menu mode. 

cipedict 

All CIPE application functions have their function names and path names defined in a 
file called ’cipedict’ (Appendix B). When a user wishes to execute an application pro- 
gram he created, he has three options. 

(1) The whole path_name and fiinction_name can be specified. This is done by 
typing the path_name plus function_name in CLI mode or by using menu entry 
’my_func’ under ’bltin+’ sub-menu in Menu mode. 

(2) The new function can be added to the function list using the CIPE provided 
function ’add_func’. This can be done by typing addfimc ("function_name", 
"path_name", "help_message") in CLI mode or by using Menu entry ’addfimc’ 
under ’bltin+’ sub-menu. 

(3) User creates his own ’cipedict’ file and adds an entry for his function. 
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1- setup 


1- list 



1- read 



1 c °py 

1- assign 


1- symbol + - 
1 
1 
| 

1- save 
l delete 
1- print 


1- alloc + - 
1 
1 
1 

1- alloc 
\- select 
l dealloc 
1- disp^list 

1- disp+ - 

1 

(- stretch + - 
1 

1- linear 
\- table 


l- zoom 
1 - draw 



(- draw color 
1- erase 



k histo 
1- cursor 
1- hardcopy 



1- mssdraw 


1- mssdisp+ - 

l- mssplot 
1- erase 



1- zoom 



I- add_func 
1- myfunc 
l- typecast 
l- pattern 


l- builtin+ - 

\- math 
stat 

1- matop 


i- matrix + - 

\ - cmatop 
l con stop 


1- rfft2 


1- xform+ - 

i- cfft2 
powerspec 



kernel 


\- filter-4- - 

\- spfilter 
1- freqfilter 
1- medfilter 
1- reseau 



kernel 


l restore + - 

1- invfilter 
i- ML 
1- ME 



1- feature_psf 
1- image_psf 



1- rotate 


1- geom+ 

\~ scale 
l- surfit 



liept 
1- gen tie 

1- reduce 


1- pyramid* - 

1- expand 
(- concat 

l- stretch + - 

1- perc 



Figure 7: Menu tree 
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input path and output path 

These two parameters allow the user to specify the default directories for all input and 
output files. These path names can be overwritten at mn time simply by specifying the 
whole absolute path name. In the CLI mode, the path names are specified by two 
separate commands as in the following examples: 

> set input path to "/ufs/mydir/" 
or 

> set output path to "/ufs/mydir/" 

Alloc submenu 


There are four functions in the ’alloc+’ submenu: ’alloc’, ’disp_list’, ’select’, and 
’dealloc’. ’alloc’ and ’dealloc’ are to allocate and de-allocate display unit. Since multi- 
ple device allocation is allowed, ’dispjist’ function allows the user to display a list of 
allocated display units and ’select’ function allows the user to select one of the units he 
allocated. 

alloc 


The ’alloc’ function allocates the display device. The host name, the display device 
type, and the size of the display window are to be specified by the user as shown in 
the example in Figure 8. In this specific example, there are two ivas display units of 
size 1024x1024 (they are refered to as ivas 0 and 1). In addition to the two ivas, the 
user may create as many Sun windows as he pleases by specifying the window size; 
these windows will be assigned a unit number automatically by the system. In the CLI 
mode, the syntax for ’alloc’ is just like any other function: 

> alloc (hostjname, display_device_type, window_size) 


select 

The ’select’ function selects the display device to be used from all the ones the user 
has allocated. In menu mode, the combination of ’host_name /device_type 
/unit_number’ is shown on the CIPE parameter window as shown in Figure 9; the user 
simply uses ~T to select the one he desires. In the CLI mode, the syntax is as follows: 

> select (display_unit_number) 


dealloc 

The ’dealloc’ function de-allocates the display unit the user has selected. 
> dealloc 
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O:alloc l:select 2:dealloc 3:disp_list 



alloc+ ~E=End data entry 'H=Help ~T=Next value 

T=Abort data entry ~D= Hardcopy TAB=Next field 


Figure 8: Display device allocation in menu mode 



Figure 9: Select display unit in menu mode 
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disp list 


The ’dispjist’ function prints a list of display units user has allocated. This function 
is particularly useful in the CLI mode because the user might not know the display unit 
numbers the system assigns to all the display windows. 

> disp_list 
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4. EXECUTIVE FUNCTIONS 


The executive functions include data management and image display functions. In 
menu mode, the data management functions are all in the ’symbol+’ submenu, and the 
display functions are in the ’disp+’ submenu. The individual functions are listed in 
alphabetical order as follows: 



save — saves a CIPE symbol to a disk file 



dealloc 

dispjist 

draw 

draw_color 

erase 

hardcopy 

histo 

select 

stretch 

zoom 


allocates a display device 

reads the cursor position and displays the 
coordinate on the display screen 

de-allocates a display device 

prints a list of allocated display units 

displays an image on the display screen 

displays a color image on the display screen 

erases the display screen 

makes a hard copy of the display screen 

generates a histogram of the displayed image 

selects a display device previously allocated 

scales the intensity of a displayed image 

scales the size of a displayed image 
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PRECEDING PAGE BLANK NOT FILMED 
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add func 


EXECUTIVE FUNCTIONS 


Name 

add June - dynamically add a function entry 
Synopsis 

add June ("function_name", "path_name", "helpjnessage") 

Description 

add June adds an entry to a function table of CIPE; the added function can be 
accessed just like the CIPE application functions during the CIPE section. 

Menu mode path 

Main — > builtin+ — > add func 
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EXECUTIVE FUNCTIONS 


alloc 


Name 

alloc - allocate a display unit 
Synopsis 

alloc (hostjiame, display jdevicejype, window _size) 

Description 

alloc allocates a display device. The host computer name is required for CIPE to 
activate the appropriate device driver and display software. In the CLI mode, the 
burdens of finding out the exact host name and the device type name are on the 
user. In menu mode, the available options are displayed on the screen. 

Menu mode path 

Main --> disp+ --> alloc+ — > alloc or 
Application Function ~> disp+ — > alloc+ --> alloc 
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assign 


EXECUTIVE FUNCTIONS 


Name 

assign — create a CIPE symbol by assigning values to it directly 
Synopsis 

symbol _nam = [data] 

Description 

assign is similar to the mathematical assignment statement. In the CLI mode, 
this function assigns a single value or a small one dimensional array to a CIPE 
symbol. For higher dimensional data (such as an image) or a large data array, 
the ’read’ function should be used instead. 

In menu mode, the user first specifies the symbol name and the dimension of the 
data array. A new menu page then appears with blank spaces for the individual 
data values. 

Menu mode path 

Main — > symbol+ — > assign or 
Application Function — > symbol+ --> assign 
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EXECUTIVE FUNCTIONS 


copy 


Name 

copy - copy all or partial data from one symbol to another 
Synopsis 

output = copy (input, (si, ss, nl, ns}) for copying partial data, 
output = input for copying the whole data array. 

Description 

copy duplicates all or part of the data from an input symbol to an output symbol. 
The area of the data to be copied is specified by {si, ss, nl, ns} where 


si : start line 

ss : start sample 

nl : number of lines 

ns : number of samples 


If the input symbol is a vector rather than an image, si and nl are still required, 
both of which should be 1. 

Menu mode path 

Main --> symbol+ --> copy or 

Application function ~> symbol+ — > copy 
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cursor 


EXECUTIVE FUNCTIONS 


Name 

cursor - read the cursor position on the display screen 

Description 

This function is not available in the CLI mode; in menu mode, it reads the cursor 
position and prints the coordinates on the CIPE parameter window 

Menu mode path 

Main --> disp+ — > cursor or 

Application function --> disp+ --> cursor 


- 24 - 



EXECUTIVE FUNCTIONS 


dealloc 


Name 

dealloc - de-allocate a selected display unit 
Synopsis 

dealloc () 

Description 

dealloc de-allocates a selected display unit. 

Menu mode path 

Main ~> disp+ --> alloc+ --> dealloc or 
Application function — > disp+ --> alloc+ — > dealloc 
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delete 


EXECUTIVE FUNCTIONS 


Name 

delete — delete a symbol and free the data area 
Synopsis 

delete (symbol_name) 

Description 

delete deletes an existing symbol and frees the data area for other usage. 
Menu mode path 

Main — > symbol+ — > delete or 
Application function --> symbol+ — > delete 
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EXECUTIVE FUNCTIONS 


disp_list 


Name 

dispjist — display a list of allocated display units 
Synopsis 

dispjist ( ) 

Description 

dispjist prints a list of allocated display windows, including for each window the 
host_name, device_type_name, window_size, and an associated unit number 
which the system assigned to each display window, (e.g. /judy/sun/256/unit=4) 

Menu mode path 

Main --> symbol+ --> dispjist or 

Application function — > symbol* — > dispjist 
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draw 


EXECUTIVE FUNCTIONS 


Name 

draw — display an image on a display device 
Synopsis 

draw (symbol_name, {startjine, start_sample}) 

Description 

draw displays an image on the selected display device, starting with pixel 
{startjine, start sample). Before using the ’draw’ function, a display device 
must be allocated. 

Menu mode path 

Main — > display+ — > draw or 

Application function — > display+ --> draw 
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EXECUTIVE FUNCTIONS 


draw color 


Name 

draw_color — display a color image on a display screen 
Synopsis 

draw_color (red_image, green_image, blue_image, {start line, start_sample}) 
Description 

draw_color displays a color image on a selected display unit, starting with pixel 
{start_line, start_sample}. Before using the ’drawcolor’ fimction, a color 
display device must be allocated. 

Menu mode path 

Main — > display* --> draw_color or 
Application function — > display* — > draw_color 
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erase 


EXECUTIVE FUNCTIONS 


Name 

erase - erase all or part of an image from a display screen 
Synopsis 

erase ("i/o/a", (sx, sy, nx, ny}) 

Description 

erase erases the portion of display screen specified by coordinates {si, ss, nl, ns) 
where 

si : start line 

ss : start sample 

nl : number of lines 

ns : number of samples 

i/o/a indicates image/overlay/all display frame buffers. 

Menu mode path 

Main — > display* — > erase or 

Application function ~> display* — > erase 
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EXECUTIVE FUNCTIONS 


list 


Name 

list — show the list of all existing CIPE symbols user has created 
Synopsis 

symbols ( ) 

Description 

Typing ’symbols’ in CLI mode or choosing the ’list’ function in menu mode 
prints out a list of existing symbols 

Menu mode path 

Main — > symbol+ ~> list or 

Application function --> symbol+ --> list 
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mss draw 


EXECUTIVE FUNCTIONS 


Name 

mssdraw — display multi-spectral images 
Synopsis 

mssdraw (image_symbol_name, band, {start line, stait_pixel}) 
Description 

mssdraw displays a multi-spectral image with specified band number. 
Menu mode path 

Main --> mssdisp+ — > mssdraw 
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EXECUTIVE FUNCTIONS 


print 


Name 

print - print the contents of a symbol 
Synopsis 

print (symbol_name, {si, ss, nl, ns}) 

Description 

In CLI mode, only one dimensional data can be printed out, while in menu mode, 
a two dimensional data area can be specified and printed out on the CIPE param- 
eter window. 

Menu mode path 

Main --> symbol-t- --> print or 
Application function --> symbol+ --> print 
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read 


EXECUTIVE FUNCTIONS 


Name 

read - read data from a disk file to a CIPE symbol 
Synopsis 

read symbol_name from "file_name" 

Description 

The disk file to be read by the CIPE function must have a corresponding CIPE 
header file with the name ’ filename. hdr’. CIPE header file contains the follow- 
ing: 

CIPE 

offset » 8 

number of lines = 128 
number of samples = 128 
number of bands = 1 
type = byte 

Menu mode path 

Main — > symbol+ — > read or 

Application function --> symbol-t- — > read 
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EXECUTIVE FUNCTIONS 


save 


Name 

save - write data from a CIPE symbol to a disk file 
Synopsis 

save (symbol_name, "file_name", {si, ss, nl, ns}) 

Description 

This function is the reverse of the 'read’ function. It allows all or part of the 
image to be saved to a disk file; the associated header file will also be created by 
CIPE with the file name "data_file_name.hdr". 

Menu mode path 

Main — > symbol+ — > save or 
Application function — > symbol+ ~> save 
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select 


EXECUTIVE FUNCTIONS 


Name 

select - select a display unit previously allocated 
Synopsis 

select (device_unit_number) 

Description 

Since multiple devices might be allocated, user uses this function to select one of 
the allocated display windows for displaying the image 

Menu mode path 

Main ~> disp+ — > alloc+ --> select or 
Application function --> disp+ — > alloc+ — > select 
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EXECUTIVE FUNCTIONS 


stretch 


Name 

stretch -- perform intensity scaling on a displayed image 
Synopsis 

stretch (min, max) 

Description 

In CLI mode, ’stretch’ scales the intensity values of a displayed grey-scale image 
between the specified min and max values. In the Menu mode, both grey-scale 
and color images can be manipulated (the user specifies the number of colors to 
be scaled and the minimum and maximum intensities for each color). In either 
case, this function only affects the intensity values on the displayed screen and 
not the data. 

Menu mode path 

Main — > disp+ — > stretch or 
Application function — > disp+ — > stretch 
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zoom 


EXECUTIVE FUNCTIONS 


Name 

zoom — zoom a displayed image 
Synopsis 

zoom ("i/o/a", zoom_factor, {sl,ss}) 

Description 

zoom scales the size of an image on the selected display screen; it does not affect 
the data. 

Option 

i/o/a where 

i : image plane 

o : overlay plane 

a : all planes 

Menu mode path 

Main --> disp+ — > zoom or 
Application function — > disp+ — > zoom 
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5. APPLICATIONS 


The individual applications are listed here in alphabetical order. They fall into the fol- 
lowing six general groups: 

Filtering 


sp filter — 

convolves an image with a given kernel 

freqfilter — 

convolves an image with a given kernel in 
frequency domain 

medfilter— 

performs median filtering 

kernel — 

generates kernel matrix in spatial domain 

reseau — 

removes reseau marks from an image 

Fourier Transform 

rfft2 

performs two dimensional FFT with a real input array 

cm 

performs two dimensional FFT with a complex input array 

powerspec 

calculates power spectrum of FFT results 

Power 

takes FFT of a real image and displays its power spectrum 

Restoration 

ML 

restores a blurred image using Maximum Likelihood 
restoration algorithm 

ME 

restores a blurred image using Maximum Entropy 
restoration algorithm 

invfilter 

restores a blurred image using recursive inverse 
convolution filtering method 

feature _psf 

creates a kernel using user specified line segments 

image _psf 

creates a kernel using user specified sub_image area 


- 39 - 


Geom 


rotate 

— 

rotates an image 

scale 

— 

scales the size of an image 

concax 

— 

concatenates two images 

tiept 

— 

resamples an image using a given tie point file 

surfit 

— 

resamples an image using a least squares fit through 
irregular tie points 

gentie 

- 

generates regular grid tie point file using a least 
squares fit through a set of irregular tie points 

reduce 

- 

performs Gaussian pyramid operation on an image 

expand 

- 

performs expand pyramid operation on an image 

merge 


mosaic two images using ’reduce’ and ’expand’ pyramid operations 

Histogram 

Manipulations 

perc 

-- 

linear scaling of an image histogram 

Built-in Utilities 


typecast 

- 

typecasting functions: char, int, and float 

math 

- 

basic mathematical functions: sqrt, log, loglO, square, 
abs, and minus 

Matrix 

- 

basic matrix operations: addition, subtraction, multiplication, 
division, and the calculation of complex conjugate 

constop 

- 

basic matrix operation between a matrix and a constant 

stat 

- 

basic statistical functions: min, max, median, std, var, and mode 

pattern 

-- 

generates images with simple patterns such as bar, checkered, etc. 
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APPLICATION FUNCTIONS 


cffl2 


Name 

c fft2 - perform FFT with complex input variables 
Synopsis 

(output_real, output imaginary) = cfft2 (inputjeal, inputimaginary, mode) 
Description 

cfft2 performs a two dimensional FFT on complex variable input data. Two input 
data arrays are required, for real and imaginary data respectively. Two output 
arrays are generated containing the real and imaginary parts of the result. (This 
function is not available in the CLI mode at this time.) 

Option 


mode = -1 : forward FFT 

mode = 1 : inverse FFT 

Menu mode path 


Main — > xform+ — > cfft2 
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cmatop 


APPLICATION FUNCTIONS 


Name 

cmatop - math functions involving two complex matrices: cmp_add, cmp sub, 
cmpjnult, cmp_div, cmpcjnult - add, subtract, multiply, divide and calculate the 
complex conjugate of two complex input symbols. 

Synopsis 

(outreal, outimagi) = cmp_add (slreal, slimagi, s2_real, s2_imagi) 
(outreal, outimagi) = cmpjub (sl real, sl imagi, s2_real, s2_imagi) 

(out real, out imagi) = cmpjnult (sl real, sl imagi, s2_real, s2_imagi) 

(out real, out imagi) = cmpjliv (sl real, sl imagi, s2_real, s2_imagi) 

(out real, out imagi) = cmpcjnult (sl real, sl imagi, s2_real, s2_imagi) 

Description 

These five functions perform basic mathematical functions between two complex 
matrices. In the Menu mode, these functions are denoted by the operation sym- 
bols: ’+’, ’/’ for addition, subtraction, multiplication, division, and ’#’ for 

the calculation of the complex conjugate. (This function is not available in the 
CLI mode at this time.) 

Menu mode path 

Main --> builtin+ --> matrix+ --> cmatop 
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APPLICATION FUNCTIONS 


concat 


Name 

concat — concatenate two images of compatible sizes together 
Synopsis 

output = concat (inputl, input2, ivert, iave) 

Description 

concat concatenates two images of compatible sizes into a single image. There 
are two parameters to be specified in addition to the two input images required 
for concatenation. If two images are to be concatenated horizontally, the parame- 
ter ’ivert’ is to be set to 0; otherwise ivert is 1. If ’iave’ is set to 1, averaging of 
the boundary will be performed. 

Menu mode path 

Main — > geom-t- ~> concat 
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constop 


APPLICATION FUNCTIONS 


Name 

constop - math functions involving a matrix and a constant: cadd, csub, cmult, 
cdiv - add, subtract, multiply, and divide the content of an input symbol by a 
given constant. 

Synopsis 

sout = cadd (s, c) 
sout = csub (s, c) 
sout = cmult (s, c) 
sout = cdiv (s, c) 

Description 

These four functions add, subtract, multiply or divide every element in the input 
symbol by a given constant. 

Menu mode path 

Main — > builtin+ — > matrix+ — > constop 
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APPLICATION FUNCTIONS 


expand 


Name 

expand - perform expand pyramid operation on an image 
Synopsis 

output = expand (input, pyramid_level) 

Description 

expand is one of the pyramid operations; it expands an image of N x N to 2N x 
2N by interpolating sample values between the given pixels. 

Menu mode path 

Main — > geom+ --> pyramid+ --> expand 
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feature_psf 


APPLICATION FUNCTIONS 


Name 

feature _psf — create a kernel using user specified features 
Synopsis 

This function requires the interactive graphic inputs, it is not available in the CLI 
mode 

Description 

feature_psf allows user to specify a feature by entering multiple line segments 
using an interactive graphic input device; these segments are saved and generated 
into a kernel for the purpose of deblurring an image. 

Menu mode path 

Main — > restore-t- — > feature_psf 
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APPLICATION FUNCTIONS 


freqfilter 


Name 

freqfilter - perform convolution / deconvolution in frequency domain 
Synopsis 

output = freqfilter (input, kernel, mode) 

Description 

freqfilter performs a convolution in the frequency domain using FFT, this is 
meant to be used when the kernel size is large (12 or larger). 

Option 

mode = 1 : inverse FFT 

mode = -1 : forward FFT 

Menu mode path 

Main --> filter+ --> freqfilter 


-47 - 


gentie 


APPLICATION FUNCTIONS 


Name 

gentie — generate a tie point file consists of regular grid tie points 
Synopsis 


gentie ("input_tie_file", order_of_fit, {nptx, npty, gapx, gapy), "output_tie_file") 

Description 

gentie performs a least squares fit through a set of irregularly spaced tie points, 
and generates regular grid tie points based on the fitted coefficients. Besides the 
input and output tie point file names, the user may also specify the default param- 
eters *order_of_fit’ and ’tie_parameter’ ({nptx, npty, gapx, gapy}) where 

nptx : number of tie points in the x direction 

npty : number of tie points in the y direction 

gapx : distance between two tie points in the x direction 

gapy : distance between two tie points in the y direction 

Menu mode path 

Main — > geom+ — > gentie 
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APPLICATION FUNCTIONS 


image_psf 


Name 

image _psf -- create a kernel using user specified sub_image area 
Synopsis 

This function requires the interactive graphic inputs; it is not available in the CLI 
mode 

Description 

image _psf allows user to specify an image by entering the coordinates of the 
upper left comer and the lower right comer using an interactive graphic input 
device. This sub image area is made into a kernel for the purpose of deblurring 
an image. 

Menu mode path 

Main --> restore+ --> image_psf 
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invfilter 


APPLICATION FUNCTIONS 


Name 

invfilter - restore a blurred image using a constrained inverse filter algorithm 
Synopsis 

output = invfilter (input, kernel, noiselevel(float), numberofiteration, 
{lamda(float), deI_lamda(float)}) 

Description 

invfilter uses a constrained inverse FFT iteratively to restore a blurred image. The 
user needs to supply the blurring kernel, the estimated noise level of the input 
image, and the maximum number of iterations desired. The parameters ’lamda’ 
(the Lagrange multiplier) and ’dellamda’ are optional if run in menu mode. 
Noise level, lamda, and del_lamda are floating numbers. 

Menu mode path 

Main — > restore+ — > invfilter 
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APPLICATION FUNCTIONS 


kernel 


Name 

kernel — generate a convolution kernel for image filtering or deblurring 
Synopsis 

output = kernel ("psf_type", { operand 1, <operand2>}) 

Description 

kernel generates the following types of convolution kernels: 
psf_attr resultant psf 

{nl, ns) a rectangular kernel containing ones 

{sigmax, sigmay} a rectangular kernel based on a Gaussian point spread function 

{magnitude, angle) a rectangular kernel containing a vector 

(radius) a square kernel based on a circular point spread function 

Menu mode path 

Main --> filter+ — > kernel 


psf_type 

"box" 

"gauss" 

"vector" 

"circle" 
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math functions 


APPLICATION FUNCTIONS 


Name 

math operations involving single argument: sqrt, log, loglO, square, abs, negate 
— these are similar to the math functions in the C math library. 

Synopsis 

output = sqrt (input) 
output = log (input) 
output = log 10 (input) 
output = square (input) 
output = abs (input) 
output = negate (input) 

Description 

All these basic math library functions require float datatype as input. If the input 
is an array, the operation is done on each element 

Menu mode path 

Main --> builtin+ ~> math 
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APPLICATION FUNCTIONS 


matop 


Name 

matop - add, subtract, multiply, and divide the contents of two input symbols 
Synopsis 

output = add (si, s2) 
output = sub (si, s2) 
output = mult (si, s2) 
output = div (si, s2) 

Description 

These four functions add, subtract, multiply or divide the contents of two input 
symbols. If the inputs are two images, the results are pixel by pixel operations. 
The two input symbols must be of the same dimension. 

Menu mode path 

Main --> builtin+ --> matrix* --> matop or 
Main —> restore* --> matop 
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ME 


APPLICATION FUNCTIONS 


Name 


ME — restore a blurred image using a maximum entropy algorithm 


Synopsis 


output = ME (input, kernel, noiselevel, dlamda, number of iteration) 


Description 

ME uses a maximum entropy algorithm to restore a blurred image. The user 
needs to supply the blurring kernel, estimated noise level of the input image, and 
the maximum number of iterations desired as well as the input image. User may 
also specify the step size d lamda; however, the default value of 0.25 will be 
used if it is not specified. Both noise level and d lamda should be specified as 
floating numbers in the GLI mode to avoid misinterpretation. 

See also 

kernel for the generation of various kernel types and sizes 
Menu mode path 

Main — > rcstore+ ~>ME 
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APPLICATION FUNCTIONS 


medfilter 


Name 

medfilter ~ perform median filtering over an image 
Synopsis 

output_image = medfilter (input_image, window_size, tolerance) 
Description 

medfilter performs median filtering with given window size. 
Menu mode path 

Main ~> filter+ — > medfilter 
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merge 


APPLICATION FUNCTIONS 


Name 

merge — mosaic two images using pyramid operations 
Synopsis 

output = merge (input 1, input2, sample 1, sample2, pyramid_level) 

Description 

merge utilizes pyramid operations ’reduce’ and ’expand’ to merge two images so 
that the boundary blends without an apparent seam line. The implementation 
allows the merge of two images to be along only a vertical line; also the length 
of each image has to be power of 2. Besides the two input images, the user 
needs to specify the vertical lines to be jointed on each image and the pyramid 
level to be used. 

Menu mode path 

Main — > geom+ — > pyramid+ --> merge 
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APPLICATION FUNCTIONS 


ML 


Name 

ML - restores a blurred image using maximum likelihood algorithm 
Synopsis 

output image = ML (input image, kernel, noise level, number of iteration) 


Description 

ML uses maximum likelihood algorithm by Lucy and Richarson to restore a 
blurred image. User needs to supply the blurring kernel, estimated noise level (a 
floating point number) of the input image, and the maximum number of iterations 
desired as well as the input image. 

See also 

kernel for the generation of various kernel types and sizes 
Menu mode path 

Main — > restore+ ~>ML 
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pattern 


APPLICATION FUNCTIONS 


Name 

pattern - generate image patterns 
Synopsis 

output = pattern ("pattemjype", { image_width, imagejength}, {min inten, 
max_inten}, {pattem_width, pattem_length}/{variance}) 

Description 

pattern generates the following image patterns: 


pattem_type 

"bar” 

"checker" 

"plane" 

"randu" 

"randg" 

Menu mode path 


pattem_attr 

{width, length} 
{width, length} 
{width, length} 

{variance} 


resultant pattern 

vertical bar stripes 
checkered pattern 
uniform intensity rectangle 
uniform random noise 
Gaussian random noise 


Main — > builtin+ — > pattern 
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APPLICATION FUNCTIONS 


perc 


Name 

perc — scale an image histogram linearly according to the specified upper and 
lower percentage cutoff 

Synopsis 

output = perc _stretch (input, lower_perc, upper_perc) 

Menu mode path 

Main --> Stretch --> perc 
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Power 


APPLICATION FUNCTIONS 


Name 

Power — perform FFT on a real image and output its power spectrum 
Synopsis 

output = Power (input) 

Description 

Power performs FFT on a real array and calculates its power spectrum 
Menu mode path 

Main --> restore+ — > Power 


- 60 - 


APPLICATION FUNCTIONS 


powerspec 


Name 

powerspec - calculate the power spectrum of FFT results 
Synopsis 

output = powerspec (real_fft_result, imaginary_fft_result) 
Description 

powerspec calculates the power spectrum of a complex array 
Menu mode path 

Main --> xform+ — > powerspec 
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reduce 


APPLICATION FUNCTIONS 


Name 

reduce — perform Gaussian pyramid on an image 
Synopsis 

output = reduce (input, pyramid_level) 

Description 

reduce is one of the basic pyramid tools called ’Gaussian pyramid’. At each 
level, the image is blurred and sub-sampled; thus the resolution of the image is 
reduced in half at each level. Image sizes should be power of two for pyramid 
algorithms. 

Menu mode path 

Main — > geom+ --> pyramid+ --> reduce 


- 62 - 



APPLICATION FUNCTIONS 


reseau 


Name 

reseau — remove reseau marks from an image 
Synopsis 

output = prep (input, "reseau_location_filename") 

Description 

reseau uses correlation to detect the reseau marks from an image and removes 
them 

Menu mode path 

Main --> filter+ --> reseau 
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rffl2 


APPLICATION FUNCTIONS 


Name 

rfft2 — perform two dimensional FFT with a real input image 
Synopsis 

(output real, outputimaginary) = rfft2 (input real, mode) 

Description 

rfft2 performs a two dimensional FFT on a real input array; the output is a com- 
plex array. 

Option 

mode = 1 : inverse FFT 
mode = -1 ; forward FFT 

Menu mode path 

Main — > xform+ — > rfft2 
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APPLICATION FUNCTIONS 


rotate 


Name 

rotate - rotate an image n degrees counterclockwise 
Synopsis 

output_image = rotate (input_image, anglejn _degree) 

Description 

rotate rotates an image counterclockwise; the angle should be specified in degrees 
( a floating point number). 

Menu mode path 

Main — > geom+ ~> rotate 
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scale 


APPLICATION FUNCTIONS 


Name 

scale — scale the size of an image 
Synopsis 

output_image = scale (inputimage, xscalefactor, y_scale_factor) 

Description 

scale scales the size of an image; the scale_factors should be specified in floating 
point numbers. 

Menu mode path 

Main — > geom+ --> scale 
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APPLICATION FUNCTIONS 


spfilter 


Name 

spfilter - convolve an image with a kernel 
Synopsis 

output_image = spfilter (input_image, kernel) 

Description 

spfilter convolves an image with a given kernel in the spatial domain. This func- 
tion is meant for use with a small kernel size. When the kernel size is larger than 
12 it is more efficient to use the freqfilter function. 

Menu mode path 

Main --> filter+ — > spfilter 
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stat 


APPLICATION FUNCTIONS 


Name 

statistical functions: min, max, median, std, var, mode — evaluate minimum, max- 
imum, median, standard deviation, variance, and mode of an input array. 

Synopsis 

output = min (input) 
output = max (input) 
output = median (input) 
output = std (input) 
output = var (input) 
output = mode (input) 

Description 

min, max, median, std, and var evaluate the minimum, maximum, median, stan- 
dard deviation, or variance of an input array, ’mode’ returns the intensity value 
of the peak in the array’s histogram. 

Menu mode path 

Main — > builtin+ — > stat 
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APPLICATION FUNCTIONS 


surfit 


Name 

surfit - perform a least squares fit through a set of tie points and warp the image 
Synopsis 

output = surfit (input, "tiept_file", order_of_fit) 

Description 

surfit performs a least squares fit through a set of irregularly spaced tie points, 
then resamples the image based on the fitted coefficients. 

Menu mode path 

Main — > geom+ — > surfit 
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tiept 


APPLICATION FUNCTIONS 


Name 

tiept — resample an image based on a set of tie points 
Synopsis 

output = tiept (input, "tiept_file") 

Description 

tiept resamples an image based on a set of regularly spaced tie points. Bi-linear 
interpolation is used while resampling. 

Menu mode path 

Main — > geom+ — > tiept 
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APPLICATION FUNCTIONS 


typecast 


Name 

typecast functions: char, int, float - convert datatype of input symbol to charac- 
ter, integer, or float datatype 

Synopsis 

output = char (input) 
output = int (input) 
output = float (input) 

Description 

These three functions convert the data in the input symbol to unsigned char, 
integer, or float datatypes respectively. 

Menu mode path 


Main ~> builtin+ — > typecast 
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Appendix A - CIPE menu configuration file 


MENU mainmenu 

setup/setup 

symbol+/Symbol 

disp+/Display 

mssdisp+/Mssdisp 

builtin+/Builtin 

xform+/Xform 

filter+/Filter 

restore+/Restore 

geom+/Geom 

stretch+/Hstretch 

END 

MENU Builtin 

symbol+/Symbol 

disp+/Display 

add_func/appl 

myfunc/appl 

typecasl/appl 

pattem/appl 

math/appl 

stat/appl 

matrix+/Matrix 

END 

MENU Matrix 

matop/menu_bltin 

cmatop/appl 

constop/appl 

END 

MENU Xform 

symbol+/Symbol 

disp+/Display 

rfft2/appl 

cfft2/appl 

powerspec/appl 

END 

MENU Filter 

symbof+/Symbol 

disp+/Display 

kemel/appl 

spfilter/appl 

freqfilter/appl 

medfilter/appl 

reseau/appl 

END 
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MENU Geom 

symbol+/Symbol 

disp+/Display 

pyram id+/Pyram id 

surfit/appl 

gentie/appl 

tiept/appl 

rotate/appl 

scale/appl 

concat/appl 

END 

MENU Pyramid 

reduce/appl 

expand/appl 

merge/appl 

END 

MENU Restore 

symbol+/Symbol 

disp+/Display 

feature_psf/appl 

image_psf/appl 

kemel/appl 

invfilter/appl 

ME/appl 

ML/appi 

END 

MENU Hstretch 

symbol+/Symbol 

disp+/Display 

percent/appl 

END 

MENU Mssdisp 

symbol+/Symbol 

stretch+/Stretch 

m ssdraw/mssdisp 

mssplot/mssdisp 

erase/dispiay 

zoom/display 

END 

MENU Display 

symbol+/Symbol 

alloc+/Alloc 

stretch+/Stretch 

zoom/display 

draw/display 

draw_color/display 

erase/display 

histo/display 

cursor/display 

hardcopy/display 

END 
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MENU Stretch 
linear/display 
table/display 
END 

MENU Alloc 

alloc/display 

select/display 

dealloc/display 

dispjist/display 

END 

MENU Symbol 

list/list_symbol 

read/read_image 

copy/copy_symbol 

assign/assign jlata 

save/save_image 

delete/delete 

print/printjiata 

END 
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function add_fune 
pathname "bltin_function" 

help "add_func (function_name, pathname, help_msg) " 
j 

! cube 

function cube_reset 
pathname "bltin_funetion" 
help "cube_reset" 
j 

! symbol stuff 
function copy 
pathname "bltin_function" 

help ’’output = copy (input, {startjine, start_sample, number j>f_line, number_of_s ample } ) 

function delete 

pathname "bltin_funetion" 

help ’’delete (input)" 

t 

Ibuiltin 2arg 
function malop 
pathname "bltin_function ,, 

help "output = matop (operation, input 1, input2)" 
function add 

pathname "appl/bltin/cp/matop 1 ' 
help "output = add (inputl, input2) " 
function sub 

pathname "appl/bltin/cp/matop" 
help "output = sub (inputl, input2) " 
function mult 

pathname "appl/bltin/cp/matop" 
help "output = mult (inputl, input2) " 
function div 

pathname "appl/bltin/cp/matop" 
help "output = div (inputl, input2) " 

| 

! typecast 

function typecast 

pathname "appl/bltin/cp/bltintype" 

help "output = typecast (output_data_type, input) " 

function char 

pathname "appl/bltin/cp/bltintype" 
help "output = char (input) " 
function int 

pathname "appl/bltin/cp/bltintype" 
help "output = int (input) " 
function float 

pathname "appl/bltin/cp/bltintype" 
help "output = float (input) " 

| 

! math functions 
function math 

pathname "appl/bltin/cp/bltinmath" 
help "output = math (operation, input) " 
function sqrt 

pathname "appl/bltin/cp/bltinmath" 
help "output = sqrt (input) " 
function log 

pathname "appl/bltin/cp/bltinmath" 
help "output = log (input) " 
function log 10 

pathname "appl/bltin/cp/bltinmath” 
help "output = log 10 (input) " 
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function square 

pathname "appl/bltin/cp/bltinmath" 
help "output = square (input) " 
function abs 

pathname "appl/bltin/cp/bldnmath" 
help "output = abs (input) " 
function negate 

pathname "appl/bltin/cp/bltinmath" 
help "output = negate (input) " 

{statistics functions 
function stat 

pathname "appl/bltin/cp/bltinstat" 
help "output = stat (operation, input) " 
function min 

pathname "appl/bltin/cp/bltinstat" 
help "output = min (input)" 
function max 

pathname "appl/bltin/cp/bltinstat" 
help "output = max (input)" 
function mean 

pathname "appl/bltin/cp/bltinstat ’’ 
help "output = mean (input)" 
function median 

pathname "appl/bltin/cp/bltinstat" 
help "output = median (input)" 
function mode 

pathname "appl/bltin/cp/bltinstat" 
help "output = mode (input)" 
function std 

pathname "appl/bltin/cp/bltinstat" 
help "output = std (input)" 
function var 

pathname " appl/bltin/cp/bltinstat’ 1 
help "output = var (input)" 

| 

! complex 2arg matrix operation 
function cmatop 

pathname "appl/bltin/cp/cmatop" 

help "{out_real, out imagi} = cmatop (operation, inputl real, inputl imagi, input2 real, input2 imagi) 

- not unplemented in CLI mode yet" “ ” ~ h 

function cmpadd 

pathname "appl^ltin/cp/cmatop" 

help {out_real, out^imagi) = cmpadd (input l_real, inputl imagi, input2 real, input2 imagi) 

- not implemented in CLI mode yet" “ " 

function cmpsub 

pathname appl/bl tin/cp/cm atop ' ' 

help {out_real, outjmagi) = cmpsub (inputl j-eal, inputl imagi, input2 real, input2 imagi) 

- not implemented in CLI mode yet" “ “ “ 

function cmpmult 

pathname "appl/bltin/cp/cmatop" 

help (out_real, outjmagi) = cmpmult (inputl_real, inputl imagi, input2 real, input2 imagi) 

- not implemented in CLI mode yet" ~ “ 

function cmpdiv 

pathname "appl/bltin/cp/cmatop" 

help " (outreal, outimagi} = cmpdiv (inputl_real, inputlimagi, input2 real, input2 imagi) 

- not implemented in CLI mode yet" 
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t 

! matrix arithmetic operation with a constant 

function cons top 

pathname "appl/bl tin/cp/cons top" 

help ’output = constop (operation, inputl, input2) M 

function cadd 

pathname "appl/bl tin/cp/cons top" 
help "output = cadd (inputl, input2)" 
function csub 

pathname "appl/bl tin/cp/cons top" 
help "output = csub (inputl, input2)" 
function cmult 

pathname "appl/bl tin/cp/cons top" 
help "output = cmult (inputl, input2)" 
function cdiv 

pathname "appl/bl tin/cp/cons top" 
help "output = cdiv (inputl, input2)" 

! display utilities 
function alloc 
pathname "display" 

help "alloc (host_name, device_type, window_size) " 

function select 

pathname "display" 

help "select (unit_number) " 

function dealloc 

pathname "display" 

help "dealloc — no argument needed" 

function disp_list 

pathname "display" 

help "disp_list — no argument needed" 
function draw 
pathname "display" 

help "draw (input, {start_line, start_s ample]) " 
function draw_color 
pathname "display" 

help "draw color (input_red, input_green, input_blue, {start_line, start_sample)) " 
function erase 
pathname "display" 

help "erase (i/o/a, {startjine, start_sample, number_of_line, number_of_sample } ) 

function Is tr etch 

pathname "display" 

help "lstretch (min, max)" 

function zoom 

pathname "display” 

help "zoom (i/o/a, zoom^f actor, {start_line, start^sample}) " 

! multi spectral data display 
function mssdisp 
pathname "disp/mssdisp" 

help "mssdisp (input, band, {start_line, start_sample)) " 
l 

! pattern generator 
function pattern 

pathname " appl/bl tin/host/pattem" 

help "output = pattern (pattem_type, pattem_size{ length, width), 
inten( dark, light), size {length, width)) - consult menu mode for 
the param of specific pattern" 
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f 

! spatial filter 
function spfilter 

pathname "appl/filter/cp/spfilter" 

help "output = spfilter (input_image, input_kemel)" 

function medfilter 

pathname "appl/filter/cp/medfilter" 

help "output = medfilter (input_image, (nlw(3), nsw(3)}, thresh(0))" 

! 

! frequency filter 
function freqfilter 
pathname "appl/filter/cp/freqfilter" 

help "output = freqfilter (input_image, input_psf, mode)” 

| 

! preprocessing 
function reseau 
pathname "appl/filter/cp/prep” 

help "output = prep (input, reseau_file) — this program requires hypercube" 

| 

! kernel generator 
function kernel 

pathname "appl/filter/host/kemel" 

help "output = kernel (psf_type, { operand 1, <operand2>})" 

I 

! power spectrum 
function Power 

pathname "appl/xform/cp/Power” 
help "output = Power (input)" 
function powerspec 
pathname "appl/xform/cp/powerspec" 

help "output = powerspec (real_fft_result, imagi fft result, fold(y/n))" 

! " ” 

! complex input fft2 
function cfft2 

pathname "appl/xform/cp/cfft2 M 

help "(output_real, outputimagi) = cfft2 (input real, input_imagi, mode) 

- not implemented in CLI mode yet" 

j 

! real input fft2 
function rfft2 

pathname "appl/xform/cp/rfft2" 

help "(output_real, output_imagi) = rfft2 (input, mode) 

— not implemented 
in CLI mode yet" 

j 

! restoration using inverse filter 
function inv filter 

pathname " app 1/restore/cp/in v filter" 

help " output = invfilter (input_image, input_psf, noise Jevel(fioat), niter, {lambda(float), deljamdatfloat)))" 

! restoration using maximum likelihood constraint 
function ML 

pathname " appl/restore/cp/M L " 

help " output = ML (input_image, input_psf, noise level(fioat), niter)" 

1 restoration using maximum entropy constraint 
function ME 

pathname "appl/restore/cp/ME" 

help " output = ME (input_image, input_psf, noise_level(float), djamda(fioat), niter)" 
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!psf 

function feature_psf 

pathname "appl/restore/host/gen_psf" 

help "it needs interactive graphic device — not available in CLI mode'* 

function image_psf 

pathname "appl/restore/host/gen_psf" 

help "it needs interactive graphic device - not available in CLI mode" 

| 

! pyramid related functions 
! pyramid reduce 
function reduce 

pathname "appl/geom/cp/reduce" 

help " output = reduce (input, pyramidjevel)" 

! pyramid expand 
function expand 

pathname "appl/geom/cp/expand" 

help " output = expand (input, pyramidjevel)" 

function merge 

pathname "appl/geom/cp/merge" 

help " output = merge (inputl, input2, sample!, sampled pyramid_level)" 

! concatenate two images 
function concat 

pathname "appl/geom/host/concat" 

help " output = concat (inputl, input2, istat(0 for horiz, 1 for vertical), 
iave(i if averaging))" 
function rotate 

pathname "appl/geom/cp/rotate" 

help " output = rotate (input, angle(float), clip_option)" 
function scale 

pathname "appl/geom/cp/scale" 

help " output = scale (input, x_scale_factor(float), y_scale_factor(fioat))" 
function surfit 

pathname "appl/geom/cp/surfit" 

help "output = surfit (input, tiept file, order_of_fit)" 

function gentie 

pathname "app 1/geo m/cp/gentie” 

help "outputtieptfile = gentie (input tie file, order_of_fit, tiept_param{npdt,npty,gapx,gapy}) 
— use menu mode" 
function tiept 

pathname "appl/geom/cp/tiept" 

help "output = tiept (input, tiept_file)" 

function data_dist 

pathname "appl/diag/cp/daLa_dist" 

help "output = data_dist (input, dist type)" 

function percent 

pathname "appVstretch/cp/perc_stretch" 

help "output = perc^s tretch (input, lower_perc, upper _perc)" 

function sar 

pathname "appl/geom/cp/sar" 
help "output = sar(input, zres/xyres)" 
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